/* Copyright (c) 2009-2010, Real-Time Innovations, Inc.
 * Copyright (c) 2010, Object Management Group, Inc.
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 * 
 * - Redistributions of source code must retain the above copyright notice,
 *   this list of conditions and the following disclaimer.
 * - Redistributions in binary form must reproduce the above copyright
 *   notice, this list of conditions and the following disclaimer in the
 *   documentation and/or other materials provided with the distribution.
 * - Neither the names of the above copyright holders nor the names of their
 *   contributors may be used to endorse or promote products derived from
 *   this software without specific prior written permission.
 * 
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL A COPYRIGHT HOLDER OR CONTRIBUTOR BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */

#include <omg/dds.hpp>
#include <example_type.hpp>

using dds::domain::DomainParticipant;
using dds::domain::TheParticipantFactory;
using dds::sub::DataReader;
using dds::sub::LoanedSamples;
using dds::sub::Sample;
using dds::sub::Subscriber;
using dds::topic::Topic;
using dds::type::TypeSupport;


static void sub_example()
{
    // QoS and listener arguments are defaulted or overloaded:
    DomainParticipant dp = TheParticipantFactory().create_participant();
    Subscriber sub = dp.create_subscriber();
    
    // No explicit type registration; instead, pass TypeSupport object.
    // TypeSupport template provides static type safety from (implicit) type
    // registration all the way through to reader/writer creation; string type
    // name can't do that.
    Topic<Foo> tp = dp.create_topic("My Topic", TypeSupport<Foo>());
    // ...or to register with a custom type name:
    // ... = dp.create_topic("My Topic", TypeSupport<Foo>("My_Registered_Name"));
    // ...or take advantage of default argument:
    // ... = dp.create_topic<Foo>("My Topic");
    
    DataReader<Foo> dr = sub.create_datareader(tp);
    {
        // LoanedSamples encapsulates begin and end iterators as well as the loan
        // itself (RAII pattern).
        // No need for separate loan vs. copy overloads: copying from the loaned
        // iterators is trivial.
        // Additional read/take arguments can be defaulted/overloaded.
        LoanedSamples<Foo> dt = dr.take();
        
        for (LoanedSamples<Foo>::Iterator it  = dt.begin();
             it != dt.end();
             ++it) {
            const Sample<Foo>& sample = *it;
            if (sample.is_valid_data()) {
                const Foo& data = sample.data();
                // ...
            }
            // 3 ways to return loan:
            // 1. Explicitly, before the end of the block:
            dt.return_loan();
        }
    }       // 2. Implicitly, in the LoanedSamples destructor
            // 3. Automatically, when the reader itself is closed:
    dr.close();
    // Close method closes the entity and all of its contained entities:
    dp.close();
    // Even participant factory could have close() to shut down all of DDS:
    //DomainParticipantFactory::get_instance().close();
}
